home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / tex-k / unixtex.ftp < prev    next >
INI File  |  1995-01-29  |  10KB  |  234 lines
  1. [unixtex.ftp: 27 January 1995]
  2.  
  3. The master version of this file is on ftp.cs.umb.edu [158.121.104.33]
  4. in pub/tex/unixtex.ftp. Mail kb@cs.umb.edu with comments or questions.
  5.  
  6. =========================================================================
  7.              Consider joining the TeX Users Group (TUG):
  8.   support the maintenance and development of the programs you retrieve.
  9.               Send membership request to: tug@tug.org.
  10. =========================================================================
  11.  
  12.             FTP INSTRUCTIONS
  13.  
  14. ... for Unix sites wanting to install (plain) TeX, LaTeX (2e), BibTeX,
  15. plain Metafont, an X window system previewer, a PostScript device
  16. driver, and/or an HP LaserJet device driver.
  17.  
  18. The files mentioned below are available from any of the following:
  19.  
  20.     Host            Internet address    TeX root dir
  21.     ----            ----------------    ------------
  22.     ftp.shsu.edu        192.92.115.10        /tex-archive
  23.     ftp.tex.ac.uk        134.151.44.19        /tex-archive
  24.     ftp.dante.de        128.69.1.12        /tex-archive
  25.     
  26.     For additional hosts, get /README.mirrors from one of these sites or
  27.     finger ctan_us@ftp.shsu.edu.
  28.  
  29.     These instructions use non-generic features of FTP supported by the
  30.     hosts above. For details, get:
  31.       /README.archive-features
  32.       /README.site-commands 
  33.  
  34. The /tex-archive/help and /tex-archive/documentation directories on
  35. these hosts have much additional documentation on all aspects of TeX.
  36.  
  37. If you do not have GNU's gunzip utility, first retrieve and install the
  38. gzip package.  Set "binary" mode by typing "bi" at your ftp prompt; then
  39.  
  40.     get /tex-archive/tools/info-zip/gzip-<version>.tar
  41.  
  42. gzip does a better job of compression than standard Unix compress, and
  43. it is (as far as is known) patent-free.  It is illegal to use Unix
  44. compress (in the USA), because it infringes a software patent.  Write to
  45. the League for Programming Freedom <lpf@uunet.uu.net> for information
  46. about fighting the new software monopolies in the US.
  47.  
  48.  
  49. Retrieving a basic set of input files and fonts:
  50. -----------------------------------------------
  51.  
  52. ftp> cd tex-archive/systems/web2c
  53. ftp> bi
  54. ftp> get lib.tar.gz
  55.  
  56.      This file contains a minimal collection of fonts (TFM files only),
  57.      (La)TeX macros, MF macros, and BibTeX files -- enough to get
  58.      started. The AMS fonts and macros are included.
  59.      
  60.      lib.tar.gz unpacks into a directory named `texmf', which you will
  61.      want in your equivalent of /usr/local/lib -- whatever you will
  62.      define as your $(datadir) in the Makefiles.
  63.  
  64.      The organization of the archive was debated at great length. We hope
  65.      it will be useful. If you don't like our organization, feel free to
  66.      move the files around as you see fit, not forgetting to redefine the
  67.      search paths and installation directories. The Makefiles,
  68.      kpathsea/HIER, kpathsea/paths.h.in, and web2c/README (``Directory
  69.      hierarchies'') have more information.
  70.  
  71.      You must decide on your directory structure *before* doing the
  72.      compilations, since you must specify default search paths, and
  73.      since the web2c Makefile tries to create the basic .fmt and .base
  74.      files, which require the .{tex,mf,tfm} input files to be in place.
  75.  
  76.  
  77. Retrieving web2c (that is, TeX, Metafont, and friends):
  78. ------------------------------------------------------
  79.  
  80. Still in tex-archive/systems/web2c:
  81.  
  82. ftp> get web.tar.gz    [Knuth's WEB sources for TeX, MF, & family:
  83.              unpacks into ./web2c-<version>]
  84. ftp> get web2c.tar.gz    [WEB-to-C source: also unpacks into ./web2c-<version>]
  85.  
  86.      You *must* retrieve and unpack *both* web.tar.gz and web2c.tar.gz.
  87.      
  88.      The web2c distribution uses an older version of the path-searching
  89.      library than the drivers below. For an interim patch, get the latest
  90.      ftp.cs.umb.edu:pub/tex/web2c.kpathsea-2.*.help file, and read it.
  91.      (I'm working on the next release of web2c as hard as I can, really.)     
  92.  
  93.  
  94. Retrieving device drivers:
  95. -------------------------
  96.  
  97.        For an X window system previewer (xdvik):
  98. ftp> cd /tex-archive/dviware/xdvik
  99. ftp> get xdvik.tar.gz    [unpacks into ./xdvik-<version>]
  100.  
  101.        For a DVI-to-PostScript translator (dvipsk):
  102. ftp> cd /tex-archive/dviware/dvipsk
  103. ftp> get dvipsk.tar.gz    [unpacks into ./dvipsk-<version>]
  104.  
  105.        For a DVI-to-PCL (HP LaserJet) translator (dviljk):
  106. ftp> cd /tex-archive/dviware/dviljk
  107. ftp> get dviljk.tar.gz    [unpacks into ./dviljk-<version>]
  108.  
  109.       [optional] For prebuilt bitmaps:
  110. ftp> cd /tex-archive/fonts/cm/pk
  111. ftp> get pk300.zip
  112.      These bitmapped fonts were generated by Metafont using the cx
  113.      mode_def for write-black 300dpi devices.
  114.  
  115.      If using the default search paths, place this set of 
  116.      Computer Modern fonts in $(fontdir)/public/cm/pk/cx.
  117.      Alternatively, let the MakeTeXPK script that comes with the drivers
  118.      build the fonts as you need them.
  119.  
  120.      The zip/unzip package is in /tex-archive/tools/info-zip.  At least
  121.      version 5.x is necessary.
  122.  
  123. ftp> quit        [end ftp session]
  124.  
  125.  
  126. Compilation and installation:
  127. ----------------------------
  128.  
  129. Each of these packages -- web2c, xdvik, dvipsk, dviljk -- contains its
  130. own installation instructions.  It is possible to build all the programs
  131. in a single make, but it is simpler to make them separately.
  132.  
  133. Compile web2c first (i.e.,, the material in both web.tar.gz and
  134. web2c.tar.gz, unpacked).  Begin by reading
  135.  
  136.     ./web2c-<version>/README
  137.     ./web2c-<version>/web2c/README
  138.     ./web2c-<version>/web2c/INSTALL
  139.     ./web2c-<version>/kpathsea/INSTALL
  140.  
  141. The INSTALL files are your guides to installation.
  142. At the simplest, you do configure; make; make install at the top level.
  143.  
  144. Remember to set up your texmf directory hierarchy before embarking on 
  145. your compilation (see "For a basic set of input files and fonts" above).
  146.  
  147. All installation processes require careful attention to detail, and
  148. knowledge of your system.  Festina lente -- make haste slowly -- and you
  149. improve your chances of success.
  150.  
  151. ftp.cs.umb.edu:pub/tex/*.help describe some common problems with the
  152. current version of web2c. Here's some more:
  153.  
  154. -- Contrary to what the web2c installation instructions imply, you must use
  155.     configure --prefix=/your/tex/root
  156. instead of editing the prefix in the Makefile(s). (Editing does work in
  157. some cases, but not all.)
  158.  
  159. -- configure does not always guess the type of yytext properly; the
  160. symptom will be compiler errors involving yytext. Replace the line
  161. `DECLARE_YYTEXT' in web2c-6.1/web2c/web2c.h with the right thing. See
  162. web2c.yytext.help.
  163.  
  164. -- If the compiler complains about something involving foil_x_wchar_t, try
  165.     make CFLAGS="-g -DNO_FOIL_X_WCHAR_T"  (for web2c); or
  166.     make CFLAGS="-g -DFOIL_X_WCHAR_T" (for everything else).
  167.  
  168. -- I messed up and declared alloca in web2c/web2c/web2c.h. Just delete
  169. the declaration. ftp.cs.umb.edu:pub/tex/web2c.alloca.help does this.
  170.  
  171. -- make clean removes *.pool in web2c/tex and web2c/mf. Use make
  172. distclean or make mostlyclean instead. Or edit tex/Makefile and
  173. mf/Makefile to remove *.pool at distclean instead of clean.
  174. ftp.cs.umb.edu:pub/tex/web2c.pool.help does this.
  175.  
  176.  
  177. Distribution on tape and CD/ROM:
  178. -------------------------------
  179.  
  180. For TeX on a single tape (4mm DAT or QIC-24), ordering information is
  181. available from unixtex@u.washington.edu.  A distribution fee in the area
  182. of US$210.00 covers administrative costs.
  183.  
  184. The Free Software Foundation distributes the minimal TeX system
  185. described here on CD/ROM. Write gnu@prep.ai.mit.edu for ordering info.
  186.  
  187. Other organizations also have TeX on a CD/ROM, but I do not know the
  188. details to include them here. Tell me if you have more info.
  189.  
  190.  
  191. Precompiled Unix TeX executables:
  192. --------------------------
  193.  
  194. (Edited from an original from George D. Greenwade <bed_gdg@SHSU.edu>.)
  195.  
  196. The files in /tex-archive/systems/unix/unixkit/ are minimal sets of
  197. precompiled executables (thanks to Sebastian Rahtz for making these sets
  198. available) for the various platforms using the latest web2c (version
  199. 6.1) package and techniques outlined in unixtex.ftp.  The one exception to
  200. this is the file share.tar.gz, which includes man pages and pool files
  201. for the distribution which may be used across all architectures.
  202.  
  203. Specifically excluded from this distribution in unixkit are the many
  204. additional macros and styles, fonts, and utilities which are available
  205. elsewhere in the CTAN archives -- the idea is to have the ability to get
  206. the latest files, but still have them in workable chunks for retrieval
  207. purposes. [Retrieve lib.tar.gz as discussed above for the minimal
  208. font/macro files.]
  209.  
  210. If you get these binaries, you do not need to get web.tar.gz and web2c.tar.gz.
  211.  
  212. After getting the precompiled binaries and share.tar.gz, you must still
  213. do the following:
  214. prompt$ cd <TEXMF>/ini; ln plain.base mf.base; ln plain.fmt tex.fmt
  215. prompt$ cd <bindir>; ln virtex tex; ln virtex latex; ln virmf mf
  216.  
  217.  
  218. Acknowledgements:
  219. ----------------
  220.  
  221. The three main sites listed above are part of the Comprehensive TeX Archive 
  222. Network (CTAN) --  the result of cooperative work among members of TUG, 
  223. DANTE [German-speaking TeX Users Group], and UKTUG [U.K. TeX Users Group], 
  224. under the leadership of George Greenwade, Chair for TUG's Technical 
  225. Working Group on TeX Archive Guidelines. Contact ctan@shsu.edu.
  226.  
  227. Special thanks to George Greenwade for establishing the CTAN site at 
  228. Sam Houston State University (US); to Rainer Schoepf, Barbara Burr, 
  229. and members of DANTE for the CTAN site in Heidelberg (Germany); and to 
  230. Sebastian Rahtz for the CTAN site in Cambridge (UK).
  231.  
  232. unixtex.ftp was conceived and created by a wonderful person (not the
  233. current maintainer!) who wishes to remain electronically anonymous.
  234.